二、MSVC + Visual Studio（Windows）

环境要求： Visual Studio 2019+，MSVC 编译工具链，x64 架构。

重要： SDK 与编译器的 ABI 必须匹配。MSVC 编译的库与 MinGW 编译的库不能混用。下载 SDK 时请选择 MSVC 版本。

2.1 创建项目

选择 C++ 控制台应用 创建，命名为 cpp_demo。

2.2 导入 SDK

将 SDK 文件拷贝到项目目录：

项目根目录/
├── libs/
│   ├── include/
│   │   ├── c_interface/
│   │   ├── cpp_interface/
│   │   └── parameter/
│   ├── nrc_host.lib          # MSVC 导入库
│   └── nrc_host.dll          # 运行时动态库
├── cpp_demo.cpp
└── cpp_demo.vcxproj

2.3 配置 Visual Studio

右键项目 → 属性 (Properties)，按以下步骤配置：

(1) 添加头文件路径

Configuration Properties → C/C++ → 常规 → 附加包含目录

$(ProjectDir)libs\include

(2) 添加库路径

Configuration Properties → 链接器 → 常规 → 附加库目录

$(ProjectDir)libs

(3) 链接库文件

Configuration Properties → 链接器 → 输入 → 附加依赖项

nrc_host.lib

(4) 生成后自动复制 DLL

Configuration Properties → 生成事件 → 生成后事件 → 命令行

copy "$(ProjectDir)libs\nrc_host.dll" "$(OutDir)"

2.4 编写最小连接代码

#include <iostream>
#include "cpp_interface/nrc_api.h"

int main()
{
    // 1. 连接控制器
    SOCKETFD fd = connect_robot("192.168.1.15", "6001");
    if (fd <= 0) {
        std::cout << "连接失败，请检查 IP 和端口" << std::endl;
        return 1;
    }

    // 2. 等待连接就绪
    while (get_connection_status(fd) != 0) {
        Sleep(200);
    }

    std::cout << "连接成功！fd = " << fd << std::endl;
    std::cout << "SDK 版本: " << get_library_version() << std::endl;

    // 3. 断开连接
    disconnect_robot(fd);
    return 0;
}

2.5 编译运行

选择 Release x64 配置，点击"本地 Windows 调试器"。控制台输出 "连接成功" 即表示配置正确。

如果使用 Debug 版本的库，需将配置切换为 Debug x64。

下一步

完成连接测试后，请浏览接口示例了解更多 API 用法。